home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 12 / Cream of the Crop 12 (Part II) / Cream of the Crop 12 (Part II).iso / OS2 / TCOS2100.ZIP / TCMDOS2.DOC < prev    next >
Encoding:
Text File  |  1996-03-05  |  69.8 KB  |  1,492 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.                                    Take Command
  9.                                      for OS/2
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.                         Introduction and Installation Guide
  19.  
  20.  
  21.  
  22.  
  23.                                    Developed By
  24.                               Rex Conn and Tom Rawson
  25.  
  26.                                  Documentation By
  27.                      Hardin Brothers, Tom Rawson, and Rex Conn
  28.  
  29.  
  30.  
  31.                                    Published By
  32.  
  33.                                  JP Software Inc.
  34.                                    P.O. Box 1470
  35.                              East Arlington, MA 02174
  36.                                       U.S.A.
  37.  
  38.                                   (617) 646-3975
  39.                                 fax (617) 646-0904
  40.  
  41.  
  42.  
  43.  
  44.  
  45.                                   ACKNOWLEDGMENTS
  46.  
  47.  
  48.              We couldn't produce a product like Take Command without the
  49.              dedication and quality work of many people.  Our thanks to:
  50.  
  51.                   JP Software Staff:  Christine Alves, Mike Bessy, Michael
  52.                   Hart, Ed Lucas, Ellen Stone.
  53.  
  54.                   Beta Test Support:  The sysops of CompuServe's CONSULT
  55.                   forum.
  56.  
  57.                   Online Support:  Brian Miller and Tess Heder of Channel 1
  58.                   BBS; Don Watkins of CompuServe's IBMNET.
  59.  
  60.                   Beta Testers:  We can't list all of our beta testers
  61.                   here.  A special thanks to all of you who helped make
  62.                   Take Command for OS/2 elegant, reliable, and friendly!
  63.  
  64.  
  65.  
  66.              The following tools are used in creating and maintaining Take
  67.              Command:
  68.  
  69.                   Compilers:       IBM C-Set/2, Microsoft Macro Assembler
  70.                   Editors:         RimStar (RimStar Technology), Brief
  71.                                    (Borland), Boxer (Boxer Software)
  72.                   Version Control: PVCS (Intersolv)
  73.                   Documentation:   Microsoft Word for Windows with Adobe
  74.                                    Type Manager
  75.  
  76.  
  77.  
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.              Copyright 1996, JP Software Inc., All Rights Reserved.  "Take
  86.              Command," "4OS2," "JP Software," and the JP Software logo and
  87.              product logos are trademarks and "4DOS" is a registered
  88.              trademark of JP Software Inc.  Other product and company names
  89.              are trademarks of their respective owners.
  90.  
  91.                                                                        3-96
  92.                                                                    Contents
  93.         -------------------------------------------------------------------
  94.  
  95.  
  96.  
  97.         Contents
  98.  
  99.  
  100.         Introduction...............................................1
  101.             How to Use This Manual.................................2
  102.             Customer Service and Technical Support.................3
  103.  
  104.         Chapter 1 / Installation...................................4
  105.             Installing Take Command................................4
  106.             Changes Made During Installation.......................5
  107.             Manual Installation....................................5
  108.                 Take Command for OS/2 Files and Directories........7
  109.             Uninstalling Take Command..............................7
  110.  
  111.         Chapter 2 / Configuration..................................9
  112.             Configuring Take Command Objects.......................9
  113.             Take Command Startup Options..........................10
  114.             Configuring Take Command..............................11
  115.             TCSTART, TCEXIT, and Startup Commands.................12
  116.             Take Command Help.....................................13
  117.  
  118.         Chapter 3 / Using Take Command............................15
  119.             Using an OS/2 Command Line............................15
  120.             Take Command and OS/2.................................16
  121.             Character-Mode Applications...........................17
  122.             Take Command, 4OS2, and 4DOS..........................19
  123.                 Using Your Batch Files and Aliases................20
  124.  
  125.         Index.....................................................23
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.  
  139.  
  140.  
  141.  
  142.  
  143.  
  144.  
  145.  
  146.         -------------------------------------------------------------------
  147.         Copr. 1996 JP Software Inc.     TCMD OS/2 Intro / Install Guide / i
  148.                                                                INTRODUCTION
  149.         -------------------------------------------------------------------
  150.  
  151.  
  152.  
  153.         INTRODUCTION
  154.  
  155.  
  156.         Welcome, and thanks for purchasing Take Command!
  157.  
  158.         We developed Take Command for OS/2 to bring the power and
  159.         convenience of our popular 4DOS and 4OS2 programs to the OS/2
  160.         Desktop.  Whether you are a computer novice or an experienced user,
  161.         Take Command for OS/2 will help you get the most out of your
  162.         computer system.  To use Take Command for OS/2, you must have OS/2
  163.         version 3.0 (Warp) or later installed on your computer.
  164.  
  165.         You're probably already familiar with graphical applications
  166.         running under OS/2, and with the command line, but you may not be
  167.         used to seeing them combined in one product.  Most graphical
  168.         applications offer limited command-line capability at best, and
  169.         most command-line utilities aren't designed for a graphical
  170.         environment like the OS/2 Desktop.
  171.  
  172.         We designed Take Command to give you the best of both worlds.
  173.         You'll probably find it most useful when you need to perform tasks
  174.         like managing your hard disk, scripting a series of steps with an
  175.         alias or batch file, or starting applications.  There are graphical
  176.         utilities that perform some of these tasks, but often you may find
  177.         it more convenient or productive to perform them from the command
  178.         line.  Unlike a character-mode session, Take Command also looks and
  179.         feels like the other OS/2 programs you use.
  180.  
  181.         Take Command offers a host of features that couldn't exist at all
  182.         in a character-mode command-line utility.  For example, you can pop
  183.         up simple dialogs from a batch file, pass keystrokes to OS/2
  184.         applications, use an OS/2-based dialog to find files or text on any
  185.         of your disks, or configure Take Command with notebook pages
  186.         instead of editing an .INI file.
  187.  
  188.         If you are familiar with the traditional command prompt, or with
  189.         4DOS or 4OS2, you won't have to change your computing habits or
  190.         unlearn anything to use Take Command.  If you know how to use
  191.         commands to display a directory, copy a file, or start an
  192.         application program, you already know how to use Take Command.  And
  193.         if you are a 4DOS or 4OS2 user, you already know how to use most of
  194.         the advanced features that we have built into Take Command.  You
  195.         can even use many of your 4DOS and 4OS2 batch files with Take
  196.         Command (see page 20 or the online help for tips about making batch
  197.         files work properly in both environments).
  198.  
  199.         Once you have Take Command installed, you can learn its new
  200.         features at your own pace.  Relax, enjoy Take Command's power, and
  201.         browse through the manuals occasionally.  Press the F1 key whenever
  202.         -------------------------------------------------------------------
  203.         Copr. 1996 JP Software Inc.     TCMD OS/2 Intro / Install Guide / 1
  204.                                                                INTRODUCTION
  205.         -------------------------------------------------------------------
  206.  
  207.  
  208.         you need help.  Take Command will soon become an essential part of
  209.         your computer, and you'll wonder how you ever got along without it.
  210.  
  211.         We are constantly working to improve Take Command.  If you have
  212.         suggestions for features or commands that we should include in the
  213.         next version, or any other way we could improve our product, please
  214.         let us know.  Many of the features in Take Command were suggested
  215.         by our users.  We can't promise to include every suggestion, but we
  216.         really do appreciate and pay attention to your comments.
  217.  
  218.  
  219.         How to Use This Manual
  220.  
  221.              This manual is only one part of the documentation that you
  222.              will need for Take Command.  It introduces the product and
  223.              will help you install it correctly on your computer.  It will
  224.              also help you understand some of the terms and concepts that
  225.              you need to know to get the most from Take Command.
  226.  
  227.              Take Command for OS/2 includes complete online help for all of
  228.              its built-in commands.  The online help provides information
  229.              about the commands and features of Take Command in an
  230.              electronic form which you can access quickly.  See page 13 for
  231.              more details about using the online help.
  232.  
  233.              We also offer a separate Reference Manual for Take Command.
  234.              It contains all of the information in the online help, in
  235.              printed form.  The Reference Manual is sometimes sold
  236.              separately from Take Command, so you may not find it in your
  237.              package.  If that's the case, use this manual to get started,
  238.              and use the online help for reference information.  A
  239.              Reference Manual can be purchased from JP Software; contact
  240.              our Customer Service department for pricing.
  241.  
  242.              You should start with this introductory manual to install Take
  243.              Command on your system.  Once you have successfully installed
  244.              Take Command, you can move back and forth between this manual
  245.              and the online help and Reference Manual.
  246.  
  247.              For the sake of clarity, we have chosen not to indicate each
  248.              of the dozens of places in this manual where you can refer to
  249.              the Reference Manual or online help for additional
  250.              information.  If you see a reference here to a command, the
  251.              initialization file TCMDOS2.INI, or any Take Command feature,
  252.              you can be sure that detailed information on that topic is
  253.              available in the reference material.
  254.  
  255.              Files distributed with Take Command for OS/2 cover important
  256.              additional information beyond what's included in the manuals.
  257.              README.DOC contains general notes, highlights of the latest
  258.         -------------------------------------------------------------------
  259.         Copr. 1996 JP Software Inc.     TCMD OS/2 Intro / Install Guide / 2
  260.                                                                INTRODUCTION
  261.         -------------------------------------------------------------------
  262.  
  263.  
  264.              release, and brief installation instructions for those
  265.              installing from a downloaded copy, and UPDATxx.DOC contains
  266.              detailed information for users with older versions on what has
  267.              changed in the latest release ("xx" is the version number).
  268.  
  269.              JP Software also offers a version of Take Command for Windows
  270.              3.1, and another version for Windows 95 and Windows NT.
  271.              Except where we specifically say otherwise, in this manual the
  272.              terms "Take Command" and "Take Command for OS/2" are used
  273.              interchangeably to refer to the version of Take Command for
  274.              the OS/2 operating system.
  275.  
  276.              If you are a 4DOS or 4OS2 user, or you use the OS/2 or DOS
  277.              prompts to do command-line work, be sure to read Chapter 3
  278.              before using Take Command.  It will give you a feel for some
  279.              of the differences between a character-mode command processor
  280.              and a Desktop-based one.
  281.  
  282.              You will likely find some parts of the documentation too
  283.              simple or too technical for your tastes.  Unless you are
  284.              convinced that one of those sections holds just the
  285.              information you need for a specific task, feel free to skip to
  286.              the next part of the manual that is more to your liking.  You
  287.              can use almost every feature of Take Command without having to
  288.              worry about other features or commands.
  289.  
  290.  
  291.         Customer Service and Technical Support
  292.  
  293.              Technical support is available via public electronic support
  294.              conferences, private electronic mail, telephone, fax, and
  295.              mail.  For complete details, including a listing of electronic
  296.              support conferences, see the Support topic in the online help,
  297.              or your Reference Manual.
  298.  
  299.              Customer service is always available through the telephone and
  300.              fax numbers listed on the title page of this manual.  See your
  301.              Reference Manual or the online help for electronic mail
  302.              addresses for our Sales and Customer Service departments.
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.         -------------------------------------------------------------------
  315.         Copr. 1996 JP Software Inc.     TCMD OS/2 Intro / Install Guide / 3
  316.                                                    CHAPTER 1 / INSTALLATION
  317.         -------------------------------------------------------------------
  318.  
  319.  
  320.  
  321.         CHAPTER 1 / INSTALLATION
  322.  
  323.  
  324.  
  325.         Installing Take Command
  326.  
  327.              To install Take Command you must run the INSTALL program on
  328.              your Take Command distribution disk.  INSTALL will copy the
  329.              files from the diskette to your hard disk, create a Desktop
  330.              object to run Take Command, and make any other changes
  331.              necessary for Take Command to run properly on your system.
  332.  
  333.              If you're installing a downloaded copy you will not have an
  334.              INSTALL program.  Instead, use the appropriate decompression
  335.              program (for example, PKUNZIP) to extract the files from your
  336.              download into a new directory.  Then follow the instructions
  337.              on page 5 to complete your installation.  If you are updating
  338.              from a previous version, check the README.DOC file for update
  339.              instructions.
  340.  
  341.              To begin the installation process, put the Take Command for
  342.              OS/2 distribution diskette in drive A.  (You can use drive B
  343.              if you prefer)  Open Drive A by selecting the Drives icon in
  344.              the OS/2 System folder and then select the Install program.
  345.  
  346.              If you prefer, you may use a 4OS2 command prompt, the OS/2
  347.              Full Screen command prompt, or the OS/2 Window command prompt
  348.              to enter the command:
  349.  
  350.                   a:install
  351.  
  352.              Once the installation program has started, just follow the
  353.              instructions on the screen to install Take Command on your
  354.              system.  Use Express Installation for a quick and simple
  355.              installation with default settings, or use Custom Installation
  356.              for finer control over the installation process.
  357.  
  358.              You can exit from the installation program at any time by
  359.              pressing Esc, then pressing "Y" in response to the next
  360.              prompt.
  361.  
  362.              The Take Command files are contained in a special library file
  363.              on the distribution diskette.  You cannot simply copy the
  364.              files from the diskette onto your system.  You must use
  365.              INSTALL to extract and decompress the Take Command files even
  366.              if you want to perform a manual installation (see below), or
  367.              if you need to replace a damaged Take Command file on your
  368.              hard disk.
  369.  
  370.         -------------------------------------------------------------------
  371.         Copr. 1996 JP Software Inc.     TCMD OS/2 Intro / Install Guide / 4
  372.                                                    CHAPTER 1 / INSTALLATION
  373.         -------------------------------------------------------------------
  374.  
  375.  
  376.              If you also have 4DOS or 4OS2, do not install Take Command in
  377.              the same directory as either product.  Some file names (for
  378.              example README.DOC) are the same in all three products, and
  379.              the files should be kept separate to avoid confusion.
  380.  
  381.  
  382.         Changes Made During Installation
  383.  
  384.              Some OS/2 installation programs make changes to your system
  385.              which are difficult to find or modify.  While the Take Command
  386.              installation program makes few such changes, we know you may
  387.              feel more comfortable knowing exactly what is done to your
  388.              system and OS/2 configuration when you install Take Command.
  389.  
  390.              Take Command's installation program takes the following steps.
  391.              Step (1) is always performed once you select a drive and
  392.              directory.  Express Installation performs steps (2) through
  393.              (4) automatically.  Custom Installation asks you to confirm
  394.              steps (2) through (4) individually.
  395.  
  396.                   1)Copy all Take Command files to a hard disk directory
  397.                     of your choice.
  398.  
  399.                   2)Brand your copy of Take Command with your name and
  400.                     serial number.
  401.  
  402.                   3)Create a folder for Take Command, and add objects to
  403.                     that folder for Take Command itself and for the online
  404.                     documentation.
  405.  
  406.                   4)Modify your CONFIG.SYS file to add the Take Command
  407.                     directory to the LIBPATH, BOOKSHELF, and DPATH
  408.                     settings, so that Take Command can find its library
  409.                     and help files.
  410.  
  411.  
  412.         Manual Installation
  413.  
  414.              There is little difference between manual and automated
  415.              installation for Take Command.  The Custom Installation option
  416.              will query you before any files are copied or existing files
  417.              are deleted or modified, so there is no real advantage to
  418.              performing these steps manually.  However, if you prefer a
  419.              manual installation, you can extract the Take Command files by
  420.              using the Custom Installation option, and choosing No when
  421.              prompted for additional installation steps after the files are
  422.              extracted.  Then follow the instructions below to complete the
  423.              installation manually.
  424.  
  425.  
  426.         -------------------------------------------------------------------
  427.         Copr. 1996 JP Software Inc.     TCMD OS/2 Intro / Install Guide / 5
  428.                                                    CHAPTER 1 / INSTALLATION
  429.         -------------------------------------------------------------------
  430.  
  431.  
  432.              You must use manual installation if you have a downloaded copy
  433.              of Take Command (for downloaded copies, see the README.DOC
  434.              file for any installation or update instructions specific to
  435.              the version you downloaded).
  436.  
  437.              To install Take Command for OS/2 manually, first extract the
  438.              files to a directory on your hard disk.  We recommend that you
  439.              use a new directory for Take Command for OS/2.  It can be on
  440.              any hard disk drive, and you can use any valid directory name.
  441.              After the files are extracted, use the Esc key to exit from
  442.              the installation program.
  443.  
  444.              Next, create a Take Command object on the Desktop or in a
  445.              folder.  To do so, switch to the folder where you want the
  446.              object to appear and either copy an existing object (use the
  447.              Copy or Create Another selection on the object's popup menu)
  448.              or drag a Program Template in from the Templates folder.
  449.  
  450.              To adjust the settings for this new object, you must open its
  451.              Settings notebook.  To do so, click the right mouse button in
  452.              the object.  When the popup menu appears, select Settings.
  453.              (If you copy an existing object, the Settings notebook may
  454.              open automatically.)
  455.  
  456.              Once the Settings notebook is open, use the Program page to
  457.              set the Path and File name to Take Command.  For example, the
  458.              Program page might look like this:
  459.  
  460.                   Path and File Name: C:\TCOS210\TCMDOS2.EXE
  461.                   Parameters:
  462.                   Working Directory: C:\
  463.  
  464.              The possible settings for the Parameter field are discussed in
  465.              detail beginning on page 10.  The Working Directory can be set
  466.              to any directory on your system.
  467.  
  468.              Once the object is created, Take Command for OS/2 will start
  469.              when you double-click the corresponding icon on the desktop.
  470.  
  471.              Take Command reads its configuration information from a file
  472.              named TCMDOS2.INI, normally stored in the Take Command
  473.              directory.  You can modify the section of this file which
  474.              begins with [TakeCommand] to configure Take Command to meet
  475.              your preferences; see page 11 for details.
  476.  
  477.              In addition to Take Command itself, you will probably want to
  478.              install the Take Command help files.  See page 13 for details
  479.              about the help system files and how to install them properly.
  480.  
  481.  
  482.         -------------------------------------------------------------------
  483.         Copr. 1996 JP Software Inc.     TCMD OS/2 Intro / Install Guide / 6
  484.                                                    CHAPTER 1 / INSTALLATION
  485.         -------------------------------------------------------------------
  486.  
  487.  
  488.              Take Command for OS/2 Files and Directories
  489.  
  490.              The automated installation procedure places all Take Command
  491.              for OS/2 files in a single directory.  You may move the files
  492.              to different directories if you wish, but you must make sure
  493.              that the files can be found by the programs that need to use
  494.              them.  The following information will help you set up your
  495.              system correctly if you are performing a manual installation:
  496.  
  497.                   TCOS2DLL.DLL is a library used by TCMDOS2.EXE.  This file
  498.                   must be in a directory which is included in the LIBPATH
  499.                   setting in CONFIG.SYS.  You can either add the Take
  500.                   Command for OS/2 directory to the LIBPATH setting, or
  501.                   copy TCOS2DLL.DLL to a standard library directory such as
  502.                   \OS2\DLL.
  503.  
  504.                   TCMDOS2.INF contains the text for the Take Command help
  505.                   system.  For the help system to work properly, the
  506.                   directory containing this file must be included in the
  507.                   SET BOOKSHELF command in CONFIG.SYS.  You can either add
  508.                   the Take Command for OS/2 directory to the BOOKSHELF
  509.                   setting, or copy TCMDOS2.INF to a standard help directory
  510.                   such as \OS2\BOOK.
  511.  
  512.                   TCMDOS2H.MSG contains the help text for the /? option
  513.                   that is available as part of each internal command.  For
  514.                   this feature to work properly, the directory containing
  515.                   this file must be included in the SET DPATH command in
  516.                   CONFIG.SYS.  You can either add the Take Command for OS/2
  517.                   directory to the DPATH setting, or copy TCMDOS2H.MSG to a
  518.                   standard DPATH directory such as \OS2.
  519.  
  520.                   SHRALIAS.EXE is a small utility that saves the shared
  521.                   alias and history list between Take Command sessions.  It
  522.                   is used by the internal command SHRALIAS (see the online
  523.                   help for details).  This file should be stored in the
  524.                   Take Command directory, or in a directory listed in your
  525.                   PATH statement.  If it is not, the SHRALIAS command will
  526.                   not work.
  527.  
  528.  
  529.         Uninstalling Take Command
  530.  
  531.              We don't expect you to have trouble using Take Command, but we
  532.              know some people feel more comfortable knowing how to
  533.              uninstall a product as well as install it.  Or, you may need
  534.              to remove Take Command from one system to move it to another
  535.              system.
  536.  
  537.  
  538.         -------------------------------------------------------------------
  539.         Copr. 1996 JP Software Inc.     TCMD OS/2 Intro / Install Guide / 7
  540.                                                    CHAPTER 1 / INSTALLATION
  541.         -------------------------------------------------------------------
  542.  
  543.  
  544.              To remove Take Command, just insert the distribution diskette,
  545.              start the INSTALL program as described on page  4, and select
  546.              the Uninstall Take Command option.  Uninstall will offer you
  547.              several options which "undo" the corresponding steps in the
  548.              installation procedure.  Complete Uninstall will take all of
  549.              the other steps automatically, and remove Take Command
  550.              entirely from your system.
  551.  
  552.              The Uninstall option will attempt to reverse the changes made
  553.              during installation.  However, if you have removed files,
  554.              changed folder or object names, or otherwise modified your
  555.              system configuration, then the program may not be able to
  556.              complete all of the steps automatically or successfully.  In
  557.              this case you will need to perform some of them manually.
  558.  
  559.              To uninstall Take Command manually, use the Drives icon or a
  560.              4OS2, OS/2 Full Screen, or OS/2 Window prompt to check the
  561.              Take Command directory for any files you placed there that you
  562.              want to save.  Then delete the remaining files from the Take
  563.              Command directory, and remove the directory.  Finally, delete
  564.              any desktop objects or folders that you have set up to run
  565.              Take Command.
  566.  
  567.  
  568.  
  569.  
  570.  
  571.  
  572.  
  573.  
  574.  
  575.  
  576.  
  577.  
  578.  
  579.  
  580.  
  581.  
  582.  
  583.  
  584.  
  585.  
  586.  
  587.  
  588.  
  589.  
  590.  
  591.  
  592.  
  593.  
  594.         -------------------------------------------------------------------
  595.         Copr. 1996 JP Software Inc.     TCMD OS/2 Intro / Install Guide / 8
  596.                                                   CHAPTER 2 / CONFIGURATION
  597.         -------------------------------------------------------------------
  598.  
  599.  
  600.  
  601.         CHAPTER 2 / CONFIGURATION
  602.  
  603.  
  604.         This chapter explains how you can tune Take Command to make it as
  605.         efficient and as useful as possible in your computing environment.
  606.         If Take Command works the way you want it to after installation,
  607.         you can skip this chapter.  You may, however, want to skim this
  608.         material to see what options are available.
  609.  
  610.         In this chapter, you'll find information about using Take Command's
  611.         startup options and startup batch files, and the basics of
  612.         configuring Take Command.  For more details on all of these topics,
  613.         including complete reference information on the configuration
  614.         options and TCMDOS2.INI, see your Reference Manual or online help.
  615.  
  616.  
  617.         Configuring Take Command Objects
  618.  
  619.              You will typically start Take Command for OS/2 from an object
  620.              on the OS/2 desktop or in a folder. Usually a single object is
  621.              sufficient, but if you prefer you can create multiple objects
  622.              to start Take Command with different startup commands or
  623.              options, or to run different batch files or other commands.
  624.              You can use these objects to run commonly-used commands and
  625.              batch files directly from the desktop.
  626.  
  627.              Each object or icon represents a different Take Command
  628.              window.  Use the Settings notebook for the object to set any
  629.              command line parameters such as a command to be executed, any
  630.              desired switches, or the name and path for TCMDOS2.INI.  More
  631.              information on command line switches and options for Take
  632.              Command is included later in this section.
  633.  
  634.              For general information on creating and configuring desktop
  635.              objects or adding objects to the OS/2 LaunchPad, see your OS/2
  636.              documentation.
  637.  
  638.              When you configure a Take Command object, place the full path
  639.              and name for TCMDOS2.EXE in the Path and File Name field, and
  640.              put any startup options that you want passed to Take Command
  641.              (e.g., the name of a startup batch file) in the Parameters
  642.              field.  For example:
  643.  
  644.                   Path and File Name:      C:\TCOS210\TCMDOS2.EXE
  645.                   Parameters:              C:\GO.BAT
  646.                   Working directory:       C:\
  647.  
  648.              When Take Command starts it automatically runs the optional
  649.              TCSTART batch file (see page 12).  You can use this file to
  650.         -------------------------------------------------------------------
  651.         Copr. 1996 JP Software Inc.     TCMD OS/2 Intro / Install Guide / 9
  652.                                                   CHAPTER 2 / CONFIGURATION
  653.         -------------------------------------------------------------------
  654.  
  655.  
  656.              load aliases and environment variables and otherwise
  657.              initialize Take Command.
  658.  
  659.              You can also place the name of a batch file, internal or
  660.              external command, or alias in the Parameters field (as shown
  661.              in the example above).  The batch file, command, or alias will
  662.              be executed after TCSTART, but before the first prompt is
  663.              displayed.
  664.  
  665.  
  666.         Take Command Startup Options
  667.  
  668.              When invoked with an empty Parameters field, Take Command will
  669.              configure itself from the TCMDOS2.INI file (see page 11), run
  670.              TCSTART (see page 12), and then display a prompt and wait for
  671.              you to type a command.  However, you may add information to
  672.              the Parameters field that will affect the way Take Command
  673.              operates.
  674.  
  675.              Take Command recognizes several options in the Parameters
  676.              field.  If you use more than one of these options, their order
  677.              is important.  The syntax for the Parameters field is:
  678.  
  679.                   [@d:\path\inifile] [//iniline]... [/L] [/LA] [/LD] [/LH]
  680.                   [/C | /K] [command]
  681.  
  682.              In the descriptions below, d: means a drive letter and \path
  683.              means a subdirectory name.
  684.  
  685.                   @d:\path\inifile:  This option sets the path and name of
  686.                   the TCMDOS2.INI file.  You do not need this option if you
  687.                   aren't using a TCMDOS2.INI file, or if the file is named
  688.                   TCMDOS2.INI and it is stored either in the same directory
  689.                   as TCMDOS2.EXE, or in the root directory of the OS/2 boot
  690.                   drive.  This option is most useful if you want to start a
  691.                   Take Command window with a specific and unique .INI file.
  692.  
  693.                   //iniline:  This option tells Take Command to treat the
  694.                   text appearing between the // and the next space or tab
  695.                   as a TCMDOS2.INI directive.  The directive should be in
  696.                   the same format as a line in the [TakeCommand] section of
  697.                   TCMDOS2.INI, but it may not contain spaces, tabs, or
  698.                   comments.  This option overrides any corresponding
  699.                   directive in your TCMDOS2.INI file.  It is a convenient
  700.                   way to send Take Command one or two simple directives
  701.                   without modifying or creating a new TCMDOS2.INI file.
  702.  
  703.                   /L, /LA, /LD, and /LH:  These options force Take Command
  704.                   to use a local alias, directory history, and / or command
  705.                   history list.  This allows you to use global lists as the
  706.         -------------------------------------------------------------------
  707.         Copr. 1996 JP Software Inc.    TCMD OS/2 Intro / Install Guide / 10
  708.                                                   CHAPTER 2 / CONFIGURATION
  709.         -------------------------------------------------------------------
  710.  
  711.  
  712.                   default, but start a specific Take Command session with
  713.                   local aliases or history.  See your Reference Manual or
  714.                   online help for details on local and global aliases and
  715.                   history.  /LA forces local aliases, /LD forces local
  716.                   directory history, /LH forces local command history, and
  717.                   /L forces all three.
  718.  
  719.                   [/C | /K] command:  This option tells Take Command to run
  720.                   a command when it starts.  The command will be run after
  721.                   TCSTART has been executed and before any command prompt
  722.                   is displayed.  It can be any valid internal or external
  723.                   command, batch file, or alias; you may include multiple
  724.                   commands by using the command separator.  All other
  725.                   startup options must be placed before the command,
  726.                   because Take Command will treat characters after the
  727.                   command as part of the command and not as additional
  728.                   startup options.
  729.  
  730.                   When the command is preceded by a /C, Take Command will
  731.                   execute the command and then exit and return to the
  732.                   parent program or the OS/2 desktop without displaying a
  733.                   prompt.
  734.  
  735.                   The /K switch has no effect; using it is the same as
  736.                   placing the command (without a /C or /K) at the end of
  737.                   the startup command line.  It is included only for
  738.                   compatibility with CMD.EXE.
  739.  
  740.                   See page 13 for details on using the command option to
  741.                   run a startup batch file.
  742.  
  743.  
  744.         Configuring Take Command
  745.  
  746.              Take Command's configuration is controlled through a file of
  747.              initialization information called TCMDOS2.INI.  This file is
  748.              created during installation, and is stored in the same
  749.              directory as TCMDOS2.EXE.  (You can move TCMDOS2.INI to the
  750.              root directory of the boot drive if you wish; Take Command
  751.              will find it in either location.)
  752.  
  753.              Take Command reads TCMDOS2.INI each time it starts, and
  754.              configures itself accordingly.
  755.  
  756.              Many of the TCMDOS2.INI options can be set directly from
  757.              within Take Command using its Configuration notebook, which is
  758.              accessible from the Configure Take Command selection on the
  759.              Setup menu.  There are several pages of options in the
  760.              Configuration notebook.
  761.  
  762.         -------------------------------------------------------------------
  763.         Copr. 1996 JP Software Inc.    TCMD OS/2 Intro / Install Guide / 11
  764.                                                   CHAPTER 2 / CONFIGURATION
  765.         -------------------------------------------------------------------
  766.  
  767.  
  768.              When you use the Configuration notebook, be sure to click the
  769.              Save button to save your changes in TCMDOS2.INI.  The OK
  770.              button will save the configuration changes for the current
  771.              session, but will not record them in TCMDOS2.INI for use in
  772.              future sessions.  The help text available from the notebook's
  773.              Help button explains which specific TCMDOS2.INI directive is
  774.              set by each item on each page.
  775.  
  776.              TCMDOS2.INI is divided into sections like other .INI files.
  777.              Each section begins with a section name in square brackets,
  778.              for example:
  779.  
  780.                   [Fonts]
  781.  
  782.              The options you can set in TCMDOS2.INI are all in the
  783.              [TakeCommand] section, which is normally the first one in the
  784.              file.  This is the section modified by the Configuration
  785.              notebook.  Take Command maintains all other sections of
  786.              TCMDOS2.INI itself; you should not modify them unless you are
  787.              instructed to do so by our support personnel.
  788.  
  789.              See the Reference Manual or the TCMDOS2.INI topic in the
  790.              online help for complete details on the format and meaning of
  791.              the directives used in the [TakeCommand] section of
  792.              TCMDOS2.INI.  Advanced Directives and Key Mapping Directives
  793.              must be entered manually.  Most other directives are
  794.              accessible from corresponding items in the configuration
  795.              notebook.
  796.  
  797.              If you prefer manual editing, or you want to enter a directive
  798.              which cannot be set from the configuration notebook, you can
  799.              edit TCMDOS2.INI with the OS/2 System Editor or any similar
  800.              ASCII text editor.  Be sure to edit only the [TakeCommand]
  801.              section.
  802.  
  803.              Take Command will not automatically re-read TCMDOS2.INI when
  804.              you edit it manually.  For manual changes to take effect, you
  805.              must exit Take Command and restart it.
  806.  
  807.  
  808.         TCSTART, TCEXIT, and Startup Commands
  809.  
  810.              Take Command executes two optional batch files automatically:
  811.              TCSTART is run whenever Take Command starts, and TCEXIT is run
  812.              whenever Take Command exits.  TCSTART and TCEXIT can be .CMD
  813.              or .BTM files.  TCSTART gives you a convenient way to load
  814.              aliases and environment variables, and otherwise initialize
  815.              Take Command.
  816.  
  817.  
  818.         -------------------------------------------------------------------
  819.         Copr. 1996 JP Software Inc.    TCMD OS/2 Intro / Install Guide / 12
  820.                                                   CHAPTER 2 / CONFIGURATION
  821.         -------------------------------------------------------------------
  822.  
  823.  
  824.              If Take Command is started with the [/C] command option (see
  825.              page 10), TCSTART, if it is available, is executed before the
  826.              command.
  827.  
  828.              See the online help or your Reference Manual for more
  829.              information on TCSTART and TCEXIT.
  830.  
  831.              To run a specific startup batch file or other command when a
  832.              particular Take Command object is started, include the batch
  833.              file or command name (with a path, if the file is not in the
  834.              startup directory) as the last item in the Parameters field on
  835.              the Program page of Take Command's Settings notebook.  The
  836.              batch file or command will be executed after TCSTART but
  837.              before the first prompt is displayed.
  838.  
  839.              You can use this capability to run a specific batch file or
  840.              command for a particular desktop object (as opposed to
  841.              TCSTART, which is run every time Take Command starts).  When
  842.              you set up a batch file or command to run in this way you are
  843.              using the command startup option (see page 10).
  844.  
  845.              For example, to run C:\STARTUP.BTM when the object starts:
  846.  
  847.                   Path and File Name:      C:\TCOS210\TCMDOS2.EXE
  848.                   Parameters:              C:\STARTUP.BTM
  849.                   Working directory:       C:\
  850.  
  851.              To execute an internal or external command, an alias, or a
  852.              batch file and then exit (return to the desktop) when it is
  853.              done, place /C command (rather than just command) as the last
  854.              item in the Parameters field.  For example:
  855.  
  856.                   Path and File Name:      D:\TCOS210\TCMDOS2.EXE
  857.                   Parameters:              /C TEST.BTM
  858.                   Working directory:       C:\
  859.  
  860.  
  861.         Take Command Help
  862.  
  863.              Complete online help for all Take Command commands and
  864.              features is provided with your copy of Take Command.  Help is
  865.              invoked with the HELP command, the F1 key, or the Help menu on
  866.              the menu bar.
  867.  
  868.              When you start the help system, Take Command opens a new
  869.              window to run the standard OS/2 help program.  The help
  870.              program displays the help text and lets you browse through it.
  871.  
  872.              You can keep the help window on the screen and return to the
  873.              Take Command window, switching between the two as needed.
  874.         -------------------------------------------------------------------
  875.         Copr. 1996 JP Software Inc.    TCMD OS/2 Intro / Install Guide / 13
  876.                                                   CHAPTER 2 / CONFIGURATION
  877.         -------------------------------------------------------------------
  878.  
  879.  
  880.              This may be useful when you are writing a batch file, working
  881.              on a complex command, or experimenting with Take Command.
  882.  
  883.              In order for the Take Command for OS/2 help system to work
  884.              properly, the help text file TCMDOS2.INF must be in a
  885.              directory listed on your BOOKSHELF path in the OS/2 CONFIG.SYS
  886.              file.  For additional details see Take Command for OS/2 Files
  887.              and Directories on page 7.
  888.  
  889.              OS/2 includes many other help files -- for example, a complete
  890.              reference to all internal and external commands in the
  891.              reference book named CMDREF.INF.  You can specify a set of
  892.              "books" to be opened when HELP or F1 is invoked.  To do so,
  893.              use the HelpBook directive in TCMDOS2.INI.  For example, to
  894.              set up Take Command for OS/2 so that both the CMDREF book and
  895.              Take Command for OS/2 help are displayed when F1 is pressed,
  896.              include the following directive in TCMDOS2.INI:
  897.  
  898.                   HelpBook=TCMDOS2+CMDREF
  899.  
  900.              When more than one book is listed in the HelpBook setting, the
  901.              OS/2 help program will display the combined group as a single
  902.              book.  The Table of Contents will include the tables of
  903.              contents from all the listed books, concatenated together as
  904.              one group of topics with no divisions to show where one book
  905.              ends and the next begins.
  906.  
  907.              The Take Command installation program sets up a separate
  908.              object for Take Command help so that you can load the help
  909.              file directly.  To create a similar object manually, use
  910.              entries like this on the Program page of the object's Settings
  911.              notebook:
  912.  
  913.                   Path and File Name:      VIEW.EXE
  914.                   Parameters:              TCMDOS2
  915.  
  916.              Take Command also supports the /? switch to display help for
  917.              any command.  Using /? will display "quick help" for the
  918.              command inside the Take Command window.  For example, to
  919.              obtain quick help on the COPY command you would use the
  920.              command:
  921.  
  922.                   [c:\] copy /?
  923.  
  924.              The file TCMDOS2H.MSG contains the help text for the /? option
  925.              used to obtain "quick help" on any command.  In order for
  926.              quick help to work properly, this file must be in a directory
  927.              listed in your DPATH setting in the OS/2 CONFIG.SYS file.  For
  928.              additional details see Take Command for OS/2 Files and
  929.              Directories on page 7.
  930.         -------------------------------------------------------------------
  931.         Copr. 1996 JP Software Inc.    TCMD OS/2 Intro / Install Guide / 14
  932.                                              CHAPTER 3 / Using Take Command
  933.         -------------------------------------------------------------------
  934.  
  935.  
  936.  
  937.         CHAPTER 3 / Using Take Command
  938.  
  939.  
  940.         Take Command works like any other OS/2 application or utility, and
  941.         most of the time you won't need to make any special adjustments for
  942.         it.  However, as you learn to use Take Command you may want to
  943.         understand in more detail how it interacts with OS/2, OS/2
  944.         applications, and DOS applications.
  945.  
  946.         The information in this chapter gives you an overview of these
  947.         topics; most are covered in more detail in the Reference Manual or
  948.         online help.  This chapter also discusses using 4DOS and 4OS2 batch
  949.         files and aliases under Take Command.
  950.  
  951.  
  952.         Using an OS/2 Command Line
  953.  
  954.              Take Command is a new environment that lets you perform tasks
  955.              easily under OS/2.  You can use it to execute commands, start
  956.              applications, and perform other work at the command line.
  957.  
  958.              In the past you may have accomplished some of these tasks with
  959.              4DOS or 4OS2, JP Software's replacement character-mode command
  960.              processors for DOS and character-mode OS/2 sessions.  Or you
  961.              may have used a character mode session to run the default
  962.              command processor (CMD.EXE for OS/2 command line sessions, or
  963.              COMMAND.COM for DOS sessions).
  964.  
  965.              In either case -- and especially if you are an experienced
  966.              user of 4DOS or 4OS2  -- you'll find plenty of familiar
  967.              features in Take Command.  You'll also find a lot that's new
  968.              or different.
  969.  
  970.              While Take Command includes most of the command-line, batch
  971.              file, and other capabilities provided by 4DOS and 4OS2, and
  972.              goes well beyond those provided by CMD.EXE, the OS/2
  973.              environment places some limitations on how Take Command
  974.              operates.
  975.  
  976.              These limitations mostly affect the use of external programs,
  977.              especially character-mode OS/2 and DOS programs.  This topic
  978.              is covered in detail beginning on page 17.
  979.  
  980.              There are some other minor differences between using Take
  981.              Command and using a 4DOS, 4OS2, or CMD.EXE session (for
  982.              example, some keystrokes are interpreted differently to
  983.              conform more closely to OS/2 conventions).  There are also
  984.              some considerations when running 4DOS or 4OS2 batch files or
  985.  
  986.         -------------------------------------------------------------------
  987.         Copr. 1996 JP Software Inc.    TCMD OS/2 Intro / Install Guide / 15
  988.                                              CHAPTER 3 / Using Take Command
  989.         -------------------------------------------------------------------
  990.  
  991.  
  992.              aliases in Take Command.  All of these differences are covered
  993.              in more detail beginning on page 19.
  994.  
  995.              Take Command also offers a wide range of new features which
  996.              are not available in 4DOS, 4OS2, or CMD.EXE sessions,
  997.              including:
  998.  
  999.                   * A built-in scrollback buffer that lets you look back
  1000.                     through the output from past commands.
  1001.  
  1002.                   * A standard OS/2 menu bar for access to many commonly
  1003.                     used Take Command features.
  1004.  
  1005.                   * A status bar showing date, time, swap file size, and
  1006.                     keyboard state.
  1007.  
  1008.                   * A customizable tool bar that gives you quick access to
  1009.                     commands and applications.
  1010.  
  1011.                   * OS/2 dialogs (accessible from the Take Command
  1012.                     Utilities menu), for editing environment variables,
  1013.                     aliases, and file descriptions.
  1014.  
  1015.                   * A standard OS/2 notebook (accessible from the Setup
  1016.                     menu) for changing startup parameters.
  1017.  
  1018.                   * High-speed, dialog-based file and text search (see
  1019.                     "Search Files / Text" on the Utilities menu).  The
  1020.                     FFIND command gives you the same capabilities at the
  1021.                     Take Command prompt.
  1022.  
  1023.                   * Commands like ACTIVATE, KEYSTACK, MSGBOX, QUERYBOX,
  1024.                     and WINDOW that allow you to use OS/2 features and
  1025.                     control OS/2 applications from your batch files.
  1026.  
  1027.  
  1028.         Take Command and OS/2
  1029.  
  1030.              Take Command for OS/2 supports OS/2's Clipboard and Drag and
  1031.              Drop features to allow it to work smoothly with other
  1032.              applications.
  1033.  
  1034.              You can use the OS/2 clipboard to copy text onto the command
  1035.              line, or to transfer text from Take Command to another
  1036.              application.  OS/2's Drag and Drop feature lets you insert
  1037.              file names from other applications onto the command line.  For
  1038.              more information about these features, see the Reference
  1039.              Manual or the topics under the Take Command and OS/2 heading
  1040.              in the online help.
  1041.  
  1042.         -------------------------------------------------------------------
  1043.         Copr. 1996 JP Software Inc.    TCMD OS/2 Intro / Install Guide / 16
  1044.                                              CHAPTER 3 / Using Take Command
  1045.         -------------------------------------------------------------------
  1046.  
  1047.  
  1048.              Take Command also offers several methods for starting OS/2
  1049.              applications, some of which go beyond what you may be used to
  1050.              when running programs from the character-mode command line.
  1051.              For complete details, see Starting OS/2 Applications in the
  1052.              online help.
  1053.  
  1054.  
  1055.         Character-Mode Applications
  1056.  
  1057.              Take Command for OS/2 starts OS/2 "graphical" applications in
  1058.              their own windows, just as if you had started them from the
  1059.              desktop.  By default, it also creates a separate character-
  1060.              mode window to run each DOS or OS/2 character mode application
  1061.              you start.
  1062.  
  1063.              If you prefer, you can run some DOS and OS/2 character-mode
  1064.              applications within the Take Command window, using an OS/2
  1065.              facility called "named pipes."  When you use this option,
  1066.              output from the application is displayed in the Take Command
  1067.              window, and no separate window is created.
  1068.  
  1069.              Because not all applications work properly with named pipes,
  1070.              you must specify which TTY applications should be run within
  1071.              the Take Command window.  To do so, use the TTY Applications
  1072.              Dialog (accessible from the Setup menu).  The dialog lets you
  1073.              specify the application name, whether the application is a DOS
  1074.              or OS/2 character-mode program, and whether or not the
  1075.              application is currently enabled to run within the Take
  1076.              Command window.  Information entered in this dialog is stored
  1077.              in the [TTYApps] section of TCMDOS2.INI.
  1078.  
  1079.              Your copy of Take Command comes with a list of applications
  1080.              which can be run within the Take Command window.  The list is
  1081.              visible when you open the dialog.  However, all applications
  1082.              in the list are initially disabled to ensure maximum
  1083.              compatibility.  This prevents problems if you have a program
  1084.              with the same name as one we tested, but which is not the same
  1085.              program.  To enable any application, select it and check the
  1086.              Enable box.  Use the Add button to add your own applications
  1087.              to the list.
  1088.  
  1089.              When you include an application name in the dialog, you can
  1090.              use an executable file name (e.g., CHKDSK.COM), or a full path
  1091.              name (e.g., C:\OS2\CHKDSK.COM).  If you use the full path
  1092.              name, the entry will apply only to that specific file.  If you
  1093.              use just the file name, the entry will apply to any file of
  1094.              that name, regardless of its location.  If you use both, the
  1095.              full path name entry will be used when you execute that
  1096.              specific file, and the file name entry will be used for other
  1097.              files of the same name.
  1098.         -------------------------------------------------------------------
  1099.         Copr. 1996 JP Software Inc.    TCMD OS/2 Intro / Install Guide / 17
  1100.                                              CHAPTER 3 / Using Take Command
  1101.         -------------------------------------------------------------------
  1102.  
  1103.  
  1104.              As an advanced option, you can also enter a path without a
  1105.              filename into the dialog (e.g. C:\OS2UTILS).  This will tell
  1106.              Take Command to treat all DOS or OS/2 character-mode programs
  1107.              in the specified directory as TTY applications.  This approach
  1108.              is useful if you have many applications of the same type in a
  1109.              single directory, but before you use it you should review the
  1110.              content of the directory carefully to be sure all the
  1111.              character-mode programs stored there are compatible with Take
  1112.              Command's TTY appliction support.
  1113.  
  1114.              If you do choose to configure an entire directory for TTY
  1115.              application support, you can create exceptions by entering
  1116.              specific filenames from that directory into the dialog as
  1117.              well.  For example, if you enable the directory C:\OS2UTILS
  1118.              for TTY support, you could also add a listing for
  1119.              C:\OS2UTILS\MYAPP.EXE (or simply for MYAPP.EXE, with no path),
  1120.              and make sure the Enable box in the dialog is not checked for
  1121.              the MYAPP entry.  This would prevent MYAPP.EXE from being
  1122.              treated as a TTY application despite the entry for the
  1123.              directory as a whole.  If you use this approach, the two
  1124.              listings can appear in any order.
  1125.  
  1126.              Once an application is listed in the dialog and enabled, it
  1127.              will run within the Take Command window whenever you start it
  1128.              from the command line.  However, if you start the application
  1129.              with the START command (without the /TTY switch, see below),
  1130.              the program will start in its own window.
  1131.  
  1132.              You can explicitly start any character-mode application within
  1133.              the Take Command window by using the START command's /TTY
  1134.              switch.  For example,
  1135.  
  1136.                   start /tty c:\os2\chkdsk.com
  1137.  
  1138.              Using this switch is the same as entering the application in
  1139.              the TTY Applications dialog and enabling it.  Using START /TTY
  1140.              is a convenient way to experiment with your DOS and OS/2
  1141.              character-mode applications to see if they are compatible with
  1142.              Take Command's TTY application support.  See the START command
  1143.              in the online help or Reference Manual for additional details.
  1144.  
  1145.              The only character-mode programs which will run properly
  1146.              within the Take Command window are those which can handle
  1147.              input and output delivered through pipes.  In technical terms,
  1148.              these are programs which read all input from the DOS or OS/2
  1149.              "standard input" device, and write output to the "standard
  1150.              output" or "standard error" device. Applications which use
  1151.              command-line parameters (rather than typed user input or
  1152.              "question and answer" dialogs), and which use simple scrolling
  1153.              (TTY-style) output, are the ones most likely to work well.
  1154.         -------------------------------------------------------------------
  1155.         Copr. 1996 JP Software Inc.    TCMD OS/2 Intro / Install Guide / 18
  1156.                                              CHAPTER 3 / Using Take Command
  1157.         -------------------------------------------------------------------
  1158.  
  1159.  
  1160.              Common applications which run successfully in the Take Command
  1161.              window include program development software like compilers and
  1162.              linkers, and some command-line utilities.  Programs which use
  1163.              "direct video" output to write complex screen displays,
  1164.              require dialog with the user, or display graphics, must be run
  1165.              in their own window.
  1166.  
  1167.              Many OS/2 character-mode programs meet this test, as do some
  1168.              DOS programs.  However, some programs -- especially DOS
  1169.              programs -- which appear to work this way may in fact use
  1170.              internal tricks or contain internal restrictions which are not
  1171.              compatible with piped input and output.
  1172.  
  1173.              For this reason, you will need to experiment to determine
  1174.              which of your DOS and OS/2 character-mode applications can run
  1175.              successfully within the Take Command window.  (If you try an
  1176.              application and it does not work, you can close the Take
  1177.              Command window with the mouse to clean up the offending
  1178.              application, then restart Take Command from your desktop.)
  1179.              Applications which do not run properly within the Take Command
  1180.              window can still be run from Take Command, but will have to
  1181.              use their own window.
  1182.  
  1183.              TTY application support for DOS programs depends on the
  1184.              TCNPDOS.COM file distributed with Take Command.  This file
  1185.              must be available in the same directory as TCMDOS2.EXE.  If it
  1186.              is not, Take Command will display an error message if you try
  1187.              to run a DOS application within the Take Command window.
  1188.  
  1189.  
  1190.         Take Command, 4OS2, and 4DOS
  1191.  
  1192.              If you're a 4OS2 or 4DOS user, many of the features in Take
  1193.              Command will seem familiar.  Because the underlying command
  1194.              processing in Take Command is based on 4OS2 and 4DOS, you'll
  1195.              find the features of those products readily accessible.  All
  1196.              the commands and switches you've used in 4OS2 or 4DOS work the
  1197.              same way and have the same meaning in Take Command; the only
  1198.              exceptions are those that don't make sense in a graphical
  1199.              environment.
  1200.  
  1201.              Other 4OS2 and 4DOS features are included in Take Command as
  1202.              well -- you'll find support for command line editing, command
  1203.              and directory histories, aliases, .BTM files, and virtually
  1204.              all the other features you already know.
  1205.  
  1206.              Even if you've never used 4OS2 or 4DOS, you'll notice plenty
  1207.              of familiar items in Take Command.  Like 4OS2 and 4DOS, Take
  1208.              Command is compatible with the default OS/2 command processor
  1209.              (CMD.EXE), and the default OS/2 DOS-session command processor
  1210.         -------------------------------------------------------------------
  1211.         Copr. 1996 JP Software Inc.    TCMD OS/2 Intro / Install Guide / 19
  1212.                                              CHAPTER 3 / Using Take Command
  1213.         -------------------------------------------------------------------
  1214.  
  1215.  
  1216.              (COMMAND.COM), either of which you may have used from the
  1217.              Command Prompts folder.
  1218.  
  1219.              There are a few differences between running 4OS2 or 4DOS (or
  1220.              CMD.EXE / COMMAND.COM) and running Take Command.  The
  1221.              remainder of this section discusses minor differences in the
  1222.              way keystrokes are interpreted by 4OS2 and Take Command.  It
  1223.              also explains some things to look for when using 4OS2 or 4DOS
  1224.              batch files and aliases (and CMD.EXE batch files) under Take
  1225.              Command.
  1226.  
  1227.              In order to support the scrollback buffer, some Take Command
  1228.              keystrokes are different from what you may be used to.  In
  1229.              particular, Take Command uses Ctrl-Up Arrow and Ctrl-Down
  1230.              Arrow (rather than Up Arrow and Down Arrow) to scroll through
  1231.              the command history at the prompt, Ctrl-PgUp (rather than
  1232.              PgUp) to open the history window, and F6 (rather than Ctrl-
  1233.              PgUp) to open the directory history window.  The arrow keys
  1234.              and PgUp and PgDn are then used to access the scrollback
  1235.              buffer.
  1236.  
  1237.              If you prefer to reverse this arrangement and use the arrow
  1238.              and PgUp keys to access the command history (as they are used
  1239.              in 4OS2 and 4DOS), and the Ctrl- keys to access the scrollback
  1240.              buffer, use the configuration notebook (accessible from the
  1241.              Setup menu) to set the Swap Scrolling Keys option.  See
  1242.              SwapScrollKeys (in the TCMDOS2.INI Configuration Directives in
  1243.              the online help) for additional details.
  1244.  
  1245.              Some command-line editing defaults have also been changed to
  1246.              conform more closely to OS/2 conventions.  In Take Command the
  1247.              default editing mode is insert, not overtype, and the default
  1248.              insert-mode cursor is a line, not a block.  You can change
  1249.              these defaults via the configuration notebook or with
  1250.              statements in TCMDOS2.INI.
  1251.  
  1252.              For complete details on all of the features listed above, see
  1253.              the online help or your Reference Manual (the Take Command for
  1254.              4OS2 Users topic, under Using Take Command in the online help,
  1255.              provides links to detailed information on each of these
  1256.              topics).
  1257.  
  1258.  
  1259.              Using Your Batch Files and Aliases
  1260.  
  1261.              As a 4OS2 or 4DOS user, you may want to use your current batch
  1262.              files and aliases with Take Command.  Or, you may want to run
  1263.              batch files developed for CMD.EXE under Take Command.  In
  1264.              general you can run these batch files under Take Command --
  1265.  
  1266.         -------------------------------------------------------------------
  1267.         Copr. 1996 JP Software Inc.    TCMD OS/2 Intro / Install Guide / 20
  1268.                                              CHAPTER 3 / Using Take Command
  1269.         -------------------------------------------------------------------
  1270.  
  1271.  
  1272.              but you need to understand how the batch files and aliases
  1273.              operate first.
  1274.  
  1275.              Take Command and 4OS2 / 4DOS aliases are separate and
  1276.              independent; Take Command does not automatically "inherit"
  1277.              aliases from a previously loaded copy of 4OS2 or 4DOS, and it
  1278.              cannot pass aliases on to a copy of 4OS2 or 4DOS started from
  1279.              the Take Command prompt.  However, you can load aliases from
  1280.              your Take Command startup batch file (see page 12).  These can
  1281.              be the same aliases you use in 4OS2 or 4DOS, or a set that is
  1282.              just for Take Command.
  1283.  
  1284.              While many of your 4OS2 and 4DOS aliases will work well under
  1285.              Take Command, you'll probably want to create a separate set of
  1286.              Take Command aliases.  This will allow your Take Command
  1287.              aliases to take advantage of features which are unavailable in
  1288.              4OS2 or 4DOS.
  1289.  
  1290.              If you want to write aliases or batch files that are used in
  1291.              both Take Command and one of our other products, but that
  1292.              behave differently in each environment, use the %_DOS variable
  1293.              to make the distinction.  For example, this batch file
  1294.              fragment uses the INPUT command to accept a string if it is
  1295.              run under 4OS2, but uses the QUERYBOX dialog box if it is run
  1296.              under Take Command:
  1297.  
  1298.                   iff "%_dos" == "PM" then
  1299.                        querybox "Enter your name:  " %%name
  1300.                   else
  1301.                        input "Enter your name:  " %%name
  1302.                   endiff
  1303.  
  1304.              Aliases and batch files which simply manipulate files or use
  1305.              other internal commands should work with little or no change
  1306.              under Take Command.  However, as a general rule, you should
  1307.              test any batch file developed for 4OS2, 4DOS, or CMD.EXE
  1308.              before assuming it will do exactly what you want under Take
  1309.              Command.  Pay particular attention to batch files which run
  1310.              complex sequences of external programs.
  1311.  
  1312.              If you use aliases or batch files to perform a sequence which
  1313.              mixes internal commands and character-mode applications, the
  1314.              sequence may not work the way you expect under Take Command.
  1315.              For example, suppose you have an alias that changes the screen
  1316.              color, starts a character-mode application, and then resets
  1317.              the color again.  Because the character-mode application
  1318.              normally will start in a separate window (see page 17) the
  1319.              color changes will not affect it -- a contingency you didn't
  1320.              have to consider when you wrote the batch file.
  1321.  
  1322.         -------------------------------------------------------------------
  1323.         Copr. 1996 JP Software Inc.    TCMD OS/2 Intro / Install Guide / 21
  1324.                                              CHAPTER 3 / Using Take Command
  1325.         -------------------------------------------------------------------
  1326.  
  1327.  
  1328.              You may also want to take advantage of some of the new
  1329.              features of Take Command to improve your batch files.  For
  1330.              example, the START command offers added flexibility in
  1331.              starting applications.  MSGBOX and QUERYBOX can be used to
  1332.              create dialog-box input prompts, and KEYSTACK and ACTIVATE
  1333.              will help control your OS/2 applications.
  1334.  
  1335.              Once you get used to these enhancements and minor differences
  1336.              you'll find that you can use Take Command to manage your
  1337.              system using the same techniques and features you already know
  1338.              from your experience with 4OS2, 4DOS, or CMD.EXE.
  1339.  
  1340.  
  1341.  
  1342.  
  1343.  
  1344.  
  1345.  
  1346.  
  1347.  
  1348.  
  1349.  
  1350.  
  1351.  
  1352.  
  1353.  
  1354.  
  1355.  
  1356.  
  1357.  
  1358.  
  1359.  
  1360.  
  1361.  
  1362.  
  1363.  
  1364.  
  1365.  
  1366.  
  1367.  
  1368.  
  1369.  
  1370.  
  1371.  
  1372.  
  1373.  
  1374.  
  1375.  
  1376.  
  1377.  
  1378.         -------------------------------------------------------------------
  1379.         Copr. 1996 JP Software Inc.    TCMD OS/2 Intro / Install Guide / 22
  1380.                                                                       Index
  1381.         -------------------------------------------------------------------
  1382.  
  1383.  
  1384.         Index                               Configuration, 6, 11
  1385.                                                 notebook, 11, 16
  1386.  
  1387.                                             Customer Service, 3
  1388.         4OS2 and 4DOS
  1389.             aliases and batch files, 20
  1390.             and Take Command, 19            Desktop
  1391.                 keystroke differences,          and uninstall, 8
  1392.                   20                            Take Command objects, 9
  1393.  
  1394.                                             Directories, for Take Command
  1395.         Alias list, local and global,         files, 7
  1396.           10
  1397.                                             Directory history list, local
  1398.         Aliases, 20                           and global, 10
  1399.             enhancing, 22
  1400.                                             DOS applications, see
  1401.         Applications                          Applications
  1402.             character-mode, 15, 17
  1403.             DOS, 15, 17                     Drag and Drop, 16
  1404.             OS/2, 17
  1405.  
  1406.                                             Help system, 2, 13
  1407.         Batch files, 20                         /? option, 14
  1408.             and OS/2, 16                        and OS/2 command reference,
  1409.             enhancing, 22                         14
  1410.                                                 location of files, 7
  1411.         Batch files, startup, 13                selecting books to view, 14
  1412.  
  1413.  
  1414.         Clipboard, 16                       .INI file, see TCMDOS2.INI
  1415.  
  1416.         CMD.EXE                             Installation, 4
  1417.             and Take Command, 19                changes to your system, 5
  1418.             batch files, 20                     manual, 5
  1419.                                                 reversing, 7
  1420.         Command history
  1421.             keystrokes, 20
  1422.             local and global, 10            Keystrokes, in 4OS2, 4DOS, and
  1423.                                               Take Command, 20
  1424.         Command-line editing, in 4OS2,
  1425.           4DOS and Take Command, 20
  1426.                                             Local and global aliases and
  1427.         Commands                              history, 10
  1428.             help on, 13
  1429.             reference information, 2
  1430.             Take Command startup, 11,       Menus, 16
  1431.               13
  1432.  
  1433.  
  1434.         -------------------------------------------------------------------
  1435.         Copr. 1996 JP Software Inc.    TCMD OS/2 Intro / Install Guide / 23
  1436.                                                                       Index
  1437.         -------------------------------------------------------------------
  1438.  
  1439.  
  1440.         Options, see Startup Options        TCMDOS2H.MSG, location of, 7,
  1441.                                               14
  1442.         OS/2 applications, see
  1443.           Applications                      TCOS2DLL.DLL, location of, 7
  1444.  
  1445.         OS/2, and Take Command, 15, 16      TCSTART, 9, 12
  1446.                                                 and startup command, 11
  1447.  
  1448.         Quick help, 14                      Technical support, 3
  1449.  
  1450.                                             Tool bar, 16
  1451.         Reference Manual, 2
  1452.  
  1453.                                             Uninstalling Take Command, 7
  1454.         Scrollback buffer, 16
  1455.             keystrokes for, 20
  1456.                                             Windows, Take Command, 9
  1457.         SHRALIAS.EXE, location of, 7
  1458.  
  1459.         Starting applications, see
  1460.           Applications
  1461.  
  1462.         Starting Take Command, 9
  1463.  
  1464.         Startup
  1465.             commands, 9, 11, 13
  1466.             options, 9, 10
  1467.                 //iniline, 10
  1468.                 /C, 11
  1469.                 /K, 11
  1470.                 /L, /LA, /LD, and /LH,
  1471.                   10
  1472.                 @inifile, 10
  1473.  
  1474.         Status bar, 16
  1475.  
  1476.         Support, 3
  1477.  
  1478.  
  1479.         Take Command, and OS/2, 15, 16
  1480.  
  1481.         TCEXIT, 9, 12
  1482.  
  1483.         TCMDOS2.INF, location of, 7, 14
  1484.  
  1485.         TCMDOS2.INI, 6, 11
  1486.             directives, on startup
  1487.               command line, 10
  1488.             location of, 10
  1489.  
  1490.         -------------------------------------------------------------------
  1491.         Copr. 1996 JP Software Inc.    TCMD OS/2 Intro / Install Guide / 24
  1492.